4D Doc Center : ch_Donnees vers graphe

4D Chart v13

ch_Donnees vers graphe


ch_Donnees vers graphe ( zone ; type ; taille ; groupCatég ; groupSéries ; numTable ; champCatég ; champSéries ; champValeurs ) -> Résultat

Paramètre	Type	Description
zone	Entier long	Zone 4D Chart
type	Entier	Type de graphe (cf. codes ci-dessous)
taille	Entier	Option pour la taille initiale du graphe 1 = Variable, 2 = Relative à la fenêtre, 3 = Relative au document
groupCatég	Entier	Grouper les données des catégories ? 0 = Non, 1 = Oui
groupSéries	Entier	Grouper les données des séries ? 0 = Non, 1 = Oui
numTable	Entier	Numéro de la table à représenter
champCatég	Entier	Numéro du champ à représenter sur l’axe des catégories
champSéries	Entier	Numéro du champ à représenter sur l’axe des séries
champValeurs	Entier	Numéro du champ à représenter sur l’axe des valeurs
Résultat	Entier long	ID d'objet du graphe

Description

La commande ch_Donnees vers graphe crée un graphe de la sélection tirée des enregistrements de numTable. La fonction renvoie l’identifiant objet du graphe.

Le tableau suivant fournit la liste des codes du paramètre type :

Code	Type de graphe
1	Aires
2	Colonnes
3	Images
4	Lignes
5	Points
6	Secteurs
7	Diagramme polaire
8	Graphes XY
100	Colonnes 3D
101	Lignes 3D
102	Aires 3D
103	Surfacique 3D
104	Triangulaire 3D
105	Epingles 3D

Le paramètre taille détermine la quantité d’espace remplie par le graphe lorsqu’il est généré et comment la taille du graphe change lorsque vous redimensionnez la fenêtre :

Si vous passez 1 (taille Variable), le graphe remplit la zone 4D Chart ou la fenêtre. Il conserve cette taille jusqu’à ce que vous la modifiiez à l’aide des poignées de sélection.
Si vous passez 2 (taille Relative à la fenêtre), le graphe remplit la zone 4D Chart ou la fenêtre externe. Si vous modifiez ensuite la taille de la fenêtre, le graphe s’y adapte automatiquement. Cependant, une fois que vous avez modifié la taille du graphe à l’aide des poignées de sélection, cette adaptation n’a plus lieu.
Si vous passez 3 (taille Relative au document), le graphe s’adapte à la dimension de page que vous avez choisie dans le dialogue Format d’impression. Il conserve cette taille jusqu’à ce que vous modifiiez la taille du graphe à l’aide des poignées de sélection.

groupCatégories spécifie si les données sur l’axe des catégories doivent être groupées ou non.

Si groupCatégories = 1, chaque élément sera unique, et les valeurs des éventuels éléments en double s’additionneront.
Si groupCatégories = 0, les valeurs de chaque élément seront représentées séparément.

groupSéries spécifie si les données sur l’axe des séries doivent être groupées ou non.

Si groupSéries = 1, chaque série sera unique, et les valeurs des éventuelles séries en double s’additionneront.
Si groupSéries = 0, les valeurs de chaque série seront représentées séparément.

numTable est le numéro de la table dont les données sont représentées. Vous pouvez obtenir le numéro d’une table en transmettant un pointeur vers la table en tant que paramètre de la fonction Table.

champCatégories est le numéro du champ à représenter sur l’axe des catégories.

champSéries est le numéro du champ à représenter sur l’axe des séries. Dans un graphe à deux dimensions, les séries s’affichent sur l’axe des éléments. Dans un graphe à trois dimensions, elles s’affichent sur l’axe des séries.

champValeurs est le numéro du champ à représenter sur l’axe des valeurs.
Vous pouvez obtenir le numéro d’un champ en transmettant un pointeur vers le champ en tant que paramètre de la fonction Champ.